home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / xrn.z / xrn / man / catn / xrn.n
Text File  |  1994-09-27  |  58KB  |  1,585 lines
  1.  
  2.  
  3.  
  4. XRN(1)                   USER COMMANDS                3 July 1991
  5.  
  6.  
  7.  
  8. NAME
  9.      xrn - an X-based interface to the USENET  news  system  that
  10.      uses the NNTP remote news server
  11.  
  12. SYNOPSIS
  13.      _x_r_n is an X-based interface to the USENET news  system  that
  14.      uses  the NNTP remote news protocol for accessing newsgroups
  15.      and articles on an NNTP server, thus allowing users to  read
  16.      news  from personal workstations by accessing a central news
  17.      repository.  This manual page applies to version 6.17.
  18.  
  19. DESCRIPTION
  20.      _x_r_n  [+/-authorFullName]  [-breakLength  len]  [-cancelCount
  21.      number] [+/-cc] [+/-ccForward] [-confirm list] [-deadLetters
  22.      file]   [-defaultLines   count]   [+/-displayLineCount]   [-
  23.      distribution  dist]  [+/-dumpCore]  [-editorCommand command]
  24.      [-includeCommand   command]   [-iconGeometry   +X+Y]    [+/-
  25.      includeHeader] [+/-extraMailHeaders] [-includePrefix "prefix
  26.      text"]   [+/-includeSep]   [+/-info]    [+/-killFiles]    [-
  27.      leaveHeaders  list]  [-lineLength  len]  [-lockFile file] [-
  28.      minLines number]  [-mailer  mailer]  [-maxLines  number]  [-
  29.      newsrcFile  file]  [-nntpServer  name]  [-organization  org]
  30.      [+/-pageArticles] [-printCommand  command]  [-replyTo  name]
  31.      [-rescanTime  time]  [+/-resetSave]  [-saveDir directory] [-
  32.      saveNewsrcFile file]  [-saveString  string]  [-signatureFile
  33.      file]  [-stripHeaders  list] [-saveMode mode] [-savePostings
  34.      file]   [+/-sortedSubjects]   [+/-subjectRead]    [-topLines
  35.      number] [-tmpDir directory] [+/-typeAhead] [+/-updateNewsrc]
  36.      [+/-useGadgets] [+/-verboseKill]  [-addButtonList  list]  [-
  37.      ngButtonList list] [-artButtonList list] [-artSpecButtonList
  38.      list]  [-allButtonList  list]  [-addBindings  bindings]   [-
  39.      ngBindings  bindings]  [-artBindings bindings] [-allBindings
  40.      bindings]
  41.  
  42.      Along with the standard toolkit options, including  display,
  43.      geometry, xrm, and iconic.
  44.  
  45. BASIC OPERATION
  46.      Don't let the size of this manual page alarm  you.   _x_r_n  is
  47.      easy  to  learn  on-line  without reading the documentation.
  48.      This manual page describes many features that may be obvious
  49.      to  the  casual observer, along with a large section on cus-
  50.      tomization (such as choosing colors  and  fonts).   It  also
  51.      describes  how to use scroll bars, buttons, and select text;
  52.      if you have used an X toolkit application before,  the  sec-
  53.      tion  titled  "BUTTONS,  SCROLL  BARS, and SELECTION" can be
  54.      skipped.
  55.  
  56.      _x_r_n uses the `.newsrc' file to determine what groups need to
  57.      be  read.   If  the  `.newsrc'  file  does  not exist, it is
  58.      created, and the  user  is  subscribed  to  the  news  group
  59.      `news.announce.newusers'.
  60.  
  61.  
  62.  
  63. X UCB                                                           1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XRN(1)                   USER COMMANDS                3 July 1991
  71.  
  72.  
  73.  
  74.      _x_r_n has four modes of operation: Add,  Newsgroup,  All,  and
  75.      Article modes.  Add mode will be entered on startup if there
  76.      are any groups that the news system knows about that are not
  77.      in  the `.newsrc' file (_i._e., new groups).  In Add mode, the
  78.      user is given a list of new groups.  Groups can then be sub-
  79.      scribed  to  and  placed  in the `.newsrc' file at the first
  80.      position, the last position, or after a group already in the
  81.      `.newsrc'  file.   When  Add  mode  is exited, any remaining
  82.      groups are added unsubscribed, so  the  user  is  not  asked
  83.      about  them  the next time _x_r_n is started.  On exit from Add
  84.      mode, or on startup if there are no  new  groups,  Newsgroup
  85.      mode  is entered.  Newsgroup mode displays the subscribed to
  86.      groups that have unread articles and the range of  available
  87.      articles.   The basic functions available in this mode allow
  88.      the user to read a group, mark all articles in  a  group  as
  89.      read,  unsubscribe  from a group, move the cursor around the
  90.      newsgroup window, change the order  of  the  list  of  news-
  91.      groups,  re-visit  the most recently visited group, and quit
  92.      _x_r_n.  In addition, the user can subscribe  to  a  group  and
  93.      specify  its  position in the `.newsrc' file, query the news
  94.      server for new articles and groups, and go  to  groups  that
  95.      are  either  not  subscribed  to or currently have no unread
  96.      articles (_i._e., groups not displayed on the  screen).   From
  97.      Newsgroup  mode  the user can go into All mode.  In All mode
  98.      the user is presented with a sorted list of all known groups
  99.      and  their  subscription status (subscribed or unsubscribed)
  100.      and can change their status or  location  in  the  `.newsrc'
  101.      file.   On exiting All mode the user is placed back in News-
  102.      group mode.  In order to read the articles in  a  particular
  103.      group,  the  user  goes from Newsgroup mode to Article mode.
  104.      In Article mode the user can sequence through  the  articles
  105.      in  the  group forward or backward, mark a group of articles
  106.      as read or unread, mark all articles in the current group as
  107.      read,  unsubscribe  to the current group, return to the last
  108.      article visited, search forward or backward for  an  article
  109.      subject  (either  for  the  exact  subject  or for a regular
  110.      expression in the subject), locally kill all articles with a
  111.      particular  subject,  and  quit (saving all changes) or exit
  112.      (leaving all articles marked unread).  In addition, the user
  113.      can  save  the current article in a file, post an article to
  114.      the group, post a followup to the current  article,  mail  a
  115.      reply  to  the  author  of an article, forward an article to
  116.      another user via mail, and return to Newsgroup mode.
  117.  
  118. NEWS SYSTEM
  119.      The news system is a set of  bulletins,  discussion  groups,
  120.      program  sources,  and other bits of information distributed
  121.      around the world under the name `USENET'.   The  information
  122.      is  generally  called  `news'  and  is broken up into `news-
  123.      groups'.  Each newsgroup deals with a subject or set of sub-
  124.      jects.   The  subjects for newsgroups are varied:  from dis-
  125.      cussions about particular versions of UNIX to movie reviews,
  126.  
  127.  
  128.  
  129. X UCB                                                           2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XRN(1)                   USER COMMANDS                3 July 1991
  137.  
  138.  
  139.  
  140.      from  information  on  the  X window system to commentary on
  141.      current social and political issues.
  142.  
  143.      For information on what newsgroups are available, answers to
  144.      commonly  asked questions, and newsgroup ediquette, read the
  145.      articles in the newsgroup `news.announce.newsusers'.   Users
  146.      who  are new to the USENET are strongly encouraged to become
  147.      familiar   with   the   contents   of   the   articles    in
  148.      `news.announce.newusers' before posting any messages.
  149.  
  150. NEWS SERVER
  151.      In order to run _x_r_n, you must have access to  an  NNTP  news
  152.      server.   If  you  do  not  have access to such a server and
  153.      would like to set one up, see the "USENET Software:  History
  154.      and  Sources" posting in news.announce.newusers for informa-
  155.      tion about where to get the  appropriate  software.   Either
  156.      the  file  `/usr/local/lib/rn/server'  (this filename may be
  157.      configured differently at some sites) must contain the  name
  158.      of  the  server machine, the environment variable NNTPSERVER
  159.      must  be  set  to  the  name  of  the  server  machine,  the
  160.      nntpServer  X resource must be set to the name of the server
  161.      machine, or the `-nntpServer' flag must be specified on  the
  162.      command  line  (with  the  order of precedence being command
  163.      line, X resource, environment variable, file).  The name can
  164.      be  either  the  actual  host  name of the NNTP server (i.e.
  165.      shambhala.berkeley.edu)  or  the   internet   number   (i.e.
  166.      128.32.132.54).   If  someone else has installed _x_r_n at your
  167.      site, then it is probably  already  configured  to  use  the
  168.      correct news server and you don't have to worry about it.
  169.  
  170. SCREEN LAYOUT
  171.      The screen displayed by _x_r_n consists of  seven  sections:  a
  172.      title  bar,  two  scrollable  text  windows, two information
  173.      bars, and two button boxes.   The  title  bar  displays  the
  174.      current  version  of  the  program.   The  top  text  window
  175.      displays information based on the mode.  In  Add  mode,  the
  176.      window  displays  all  groups  that are not currently in the
  177.      `.newsrc' file, one per line.  In Newsgroup mode, the window
  178.      displays  the groups containing unread articles.  Each group
  179.      is represented by a line of the form:
  180.  
  181.      Unread news in <group name>           <num> article(s) + <old> old
  182.  
  183.      <group name> is the name of the group, <num> is  the  number
  184.      of unread articles, and <old> is the number of read articles
  185.      that are still available (i.e. have not been expired) on the
  186.      news  server.   If  "List  old" is toggled on, then the word
  187.      "Unread" will not appear on the lines of newsgroups with  no
  188.      unread  articles,  and furthermore, the words "news in" will
  189.      not appear on the lines  of  newsgroups  with  no  available
  190.      articles at all.
  191.  
  192.  
  193.  
  194.  
  195. X UCB                                                           3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XRN(1)                   USER COMMANDS                3 July 1991
  203.  
  204.  
  205.  
  206.      In Article mode, the window displays a list of subjects  for
  207.      the  articles  in  the current group, with each subject line
  208.      being represented by a line of the form:
  209.  
  210.      [+u][SP] <num>    <subject of the article> [<lines>] <author>
  211.  
  212.      where <num> is the article number, <lines> is the number  of
  213.      lines  in  the article (when available), and <author> is the
  214.      author of the article.  A `+' in the  first  position  means
  215.      that  the article has been read, a `u' in the first position
  216.      means that the article has been marked as unread, a  'S'  in
  217.      the second position means that the article has been saved to
  218.      a file, and a 'P' in the  second  position  means  that  the
  219.      article has been printed.
  220.  
  221.      The top information bar displays information about the mode,
  222.      the  buttons in the top button box, and error messages.  The
  223.      top button box has buttons that are specific to the mode and
  224.      apply to the information in the top text window.  The bottom
  225.      text window displays articles in Article mode and a list  of
  226.      all  known groups and their subscription status in All mode.
  227.      The bottom information bar displays  information  about  the
  228.      mode,  the  buttons in the bottom button box, and error mes-
  229.      sages.  The bottom button box has buttons that are  specific
  230.      to  the mode and apply to the information in the bottom text
  231.      window.
  232.  
  233. BUTTONS, SCROLL BARS, AND SELECTION
  234.      All button and text selection commands  are  done  with  the
  235.      left  mouse  button.   Single-line  text selection is accom-
  236.      plished by clicking the left mouse  button  on  the  desired
  237.      line.   Multiple-line  selection is accomplished by clicking
  238.      the left mouse button on the first line, holding the  button
  239.      down, dragging the mouse to the last line, and releasing the
  240.      mouse button.  Multiple-line selection can  also  be  accom-
  241.      plished  by  left-clicking  on  the  first  line, and right-
  242.      clicking on the last line.  Selected lines appear in reverse
  243.      video (the foreground and background colors are switched).
  244.  
  245.      The text windows are scrolled with the  scroll  bar  on  the
  246.      left  side of the window.  Clicking the left mouse button in
  247.      the scroll bar will scroll the text down some fraction of  a
  248.      page;  clicking  the  right  mouse  button in the scroll bar
  249.      similarly scrolls up.  Clicking the middle mouse button will
  250.      scroll  over larger areas: clicking at the top of the scroll
  251.      bar will scroll to the top of the text, clicking in the mid-
  252.      dle  will  scroll to the middle of the text, and clicking at
  253.      the bottom will scroll to the bottom of the text.  For those
  254.      who  like  using  the  keyboard, hitting control-V while the
  255.      mouse cursor is in a scrollable text window will  cause  the
  256.      window  to  scroll  down one page, meta-V will scroll up one
  257.      page.
  258.  
  259.  
  260.  
  261. X UCB                                                           4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. XRN(1)                   USER COMMANDS                3 July 1991
  269.  
  270.  
  271.  
  272.      Hitting the space bar (while the mouse cursor is in the  top
  273.      button box) will do the right thing; scroll the article text
  274.      window when appropriate, go to the next article at  the  end
  275.      of  the current article, go to newsgroup mode when done with
  276.      all articles in the current group, and go to the next  group
  277.      when in newsgroup mode.
  278.  
  279.      Clicking the middle button on a newsgroup in Newsgroup  mode
  280.      causes  _x_r_n to enter Article mode in that newsgroup.  Click-
  281.      ing the middle button on an article in Article  mode  causes
  282.      that article to be displayed.
  283.  
  284. MODES
  285.      The next few sections describe the individual modes in  _x_r_n.
  286.      Each button in the various modes is described with the label
  287.      for the button and the name of the button.  The name of  the
  288.      button  can be used in X resources, in the button lists, and
  289.      in the bindings tables.
  290.  
  291. ADD MODE
  292.      Add mode is entered  when  new  groups  have  been  detected
  293.      (groups  that the news system knows about but are not in the
  294.      `.newsrc' file).
  295.  
  296.      quit (addQuit)
  297.           Add remaining groups in the list to `.newsrc' as unsub-
  298.           scribed; go to group mode.
  299.  
  300.      add first (addFirst)
  301.           Add the  current  group(s)  to  the  beginning  of  the
  302.           `.newsrc'  file  and  mark  as subscribed.  The current
  303.           group is the selected group(s), or  the  group  on  the
  304.           line containing the cursor.
  305.  
  306.      add last (addLast)
  307.           Add the current group(s) to the end  of  the  `.newsrc'
  308.           file and mark as subscribed.
  309.  
  310.      add after group (addAfter)
  311.           Add the current group(s) after a group already  in  the
  312.           `.newsrc'.   A  dialog box is used to allow the user to
  313.           enter the name of the group to  add  the  group  after.
  314.           The  mouse  cursor must be in the dialog box for _x_r_n to
  315.           accept text (however, it does not have  to  be  in  the
  316.           type-in  area).   The dialog box has two options: abort
  317.           and add.  No other buttons  on  the  screen  will  work
  318.           until  the  user  has  selected an option in the dialog
  319.           box.  Hitting carriage return is the same  as  clicking
  320.           the  add  button  (in all _x_r_n dialog boxes hitting car-
  321.           riage return is the same as clicking in  the  rightmost
  322.           button of the dialog box).
  323.  
  324.  
  325.  
  326.  
  327. X UCB                                                           5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. XRN(1)                   USER COMMANDS                3 July 1991
  335.  
  336.  
  337.  
  338.      add unsubscribed (addUnsub)
  339.           Add the current group(s) to the end  of  the  `.newsrc'
  340.           file and mark as unsubscribed.
  341.  
  342.  
  343. NEWSGROUP MODE
  344.      Newsgroup mode informs the user of the  groups  with  unread
  345.      news  and  gives  the  user  control  over  which groups are
  346.      visited.  Clicking the middle button on  a  newsgroup  entry
  347.      will enter that newsgroup.
  348.  
  349.      quit (ngQuit)
  350.           quit _x_r_n.
  351.  
  352.      read group (ngRead)
  353.           Read the articles in the current  group.   The  current
  354.           group  is either the first one selected (if one or more
  355.           are selected) or the one on  the  line  containing  the
  356.           cursor.   If  all  groups  have been read, the user can
  357.           still access groups by using the  goto  newsgroup  com-
  358.           mand.  Hitting the space bar with the cursor in the top
  359.           button box will call this function.
  360.  
  361.      next (ngNext)
  362.           Move the cursor to the next group, leaving the articles
  363.           in the current group untouched.
  364.  
  365.      prev (ngPrev)
  366.           Move the cursor to  the  previous  group,  leaving  the
  367.           articles in the current group untouched.
  368.  
  369.      catch up (ngCatchUp)
  370.           Mark all articles in the current group as read.
  371.  
  372.      subscribe (ngSubscribe)
  373.           Subscribe to a group.  A dialog box is  used  to  allow
  374.           the  user  to  enter the name of the group.  The dialog
  375.           box has the following options: abort, prev group  (sub-
  376.           scribe to the previous group visited), first (put group
  377.           in the beginning of  the  `.newsrc'  file),  last  (put
  378.           group  in  the  end of the `.newsrc' file), and current
  379.           position (put group at the  position  of  the  cursor).
  380.           This command can also be used to change the position of
  381.           a subscribed group.  Hitting carriage return after typ-
  382.           ing  in  the  name  is the same as clicking the current
  383.           position button.
  384.  
  385.      unsubscribe (ngUnsub)
  386.           Unsubscribe from the current group.
  387.  
  388.      goto newsgroup (ngGoto)
  389.           Go to a group that is  not  currently  displayed.   The
  390.  
  391.  
  392.  
  393. X UCB                                                           6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. XRN(1)                   USER COMMANDS                3 July 1991
  401.  
  402.  
  403.  
  404.           first  unread article is displayed.  If all articles in
  405.           the group have been read, the last article in the group
  406.           is displayed.  The name specified can be a substring of
  407.           the group name or a regular expression.
  408.  
  409.      all groups (ngAllGroups)
  410.           Display all of the groups that exist,  their  subscrip-
  411.           tion  status,  and  a  set  of buttons for changing the
  412.           status.
  413.  
  414.      rescan (ngRescan)
  415.           Query the server for any new groups or articles.
  416.  
  417.      prev group (ngPrevGroup)
  418.           Re-visit the previous group visited.
  419.  
  420.      list old (ngListOld)
  421.           List all of the groups subscribed to, independent of if
  422.           they have any unread articles.
  423.  
  424.      select groups (ngSelect)
  425.           Records the groups currently selected.   If  no  groups
  426.           are selected, nothing is recorded.
  427.  
  428.      move (ngMove)
  429.           Moves the groups previously selected  with  the  select
  430.           groups  command to the current cursor position.  If the
  431.           cursor is currently inside the groups to be  moved,  no
  432.           groups are moved.  If any other button is invoked after
  433.           select groups and before move, the selection  is  lost,
  434.           and no groups are moved.
  435.  
  436.      exit (ngExit)
  437.           Quit _x_r_n, leaving the `.newsrc'  file  unchanged  since
  438.           the   last  `rescan'  operation  or  `checkpoint'.   If
  439.           `updateNewsrc' is on, then the `.newsrc' file  is  kept
  440.           up to date with the last time Article mode was exited.
  441.  
  442.      checkpoint (ngCheckPoint)
  443.           Update the `.newsrc' file.  _x_r_n  normally  updates  the
  444.           `.newsrc'  file  on  `rescan'  and  `quit' in Newsgroup
  445.           mode. This allows you  to  update  the  `.newsrc'  file
  446.           without  exiting _x_r_n or reconnecting to the server (see
  447.           also 'artCheckPoint').
  448.  
  449.      gripe (ngGripe)
  450.           Send a gripe (bug, bug fix, complaint, feature request,
  451.           etc.) to the authors of the program.
  452.  
  453.      post (ngPost)
  454.           Post an article to a newsgroup. See "post" under  Arti-
  455.           cle mode for more information.
  456.  
  457.  
  458.  
  459. X UCB                                                           7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. XRN(1)                   USER COMMANDS                3 July 1991
  467.  
  468.  
  469.  
  470. ALL MODE
  471.      All mode allows the user to  change  both  the  subscription
  472.      status  and  the  `.newsrc'  file  position of any available
  473.      group.  All operations can apply to multiple groups.   Thus,
  474.      the  user  should  never  have  to  use a text editor on the
  475.      `.newsrc' file.  Hitting the space bar will scroll the  bot-
  476.      tom text window.
  477.  
  478.      quit (allQuit)
  479.           Update the `.newsrc' file and return to group mode.
  480.  
  481.      subscribe (allSub)
  482.           Subscribe to the  current  group,  leaving  it  at  its
  483.           current position in the `.newsrc' file.
  484.  
  485.      subscribe first (allFirst)
  486.           Subscribe to the current group and add it to the begin-
  487.           ning of the `.newsrc' file.
  488.  
  489.      subscribe last (allLast)
  490.           Subscribe to the current group and add it to the end of
  491.           the `.newsrc' file.
  492.  
  493.      subscribe after group (allAfter)
  494.           Subscribe to the current group and add it after a  par-
  495.           ticular  group  (for  which the user is prompted with a
  496.           dialog box) in the `.newsrc' file.
  497.  
  498.      unsubscribe (allUnsub)
  499.           Unsubscribe the current group.
  500.  
  501.      goto group (allGoto)
  502.           Go to the current newsgroup.
  503.  
  504.      select groups (allSelect)
  505.  
  506.      move (allMove)
  507.           Same as the "select groups" and "move" buttons in News-
  508.           group mode.
  509.  
  510.      toggle order (allToggle)
  511.           Toggle the  order  of  the  newsgroups  in  the  window
  512.           between `.newsrc' order and alphabetical order.
  513.  
  514.      scroll forward (allScroll)
  515.           Scroll the all groups window forward a page.
  516.  
  517.      scroll backward (allScrollBack)
  518.           Scroll the all groups window backwards a page.
  519.  
  520. ARTICLE MODE
  521.  
  522.  
  523.  
  524.  
  525. X UCB                                                           8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. XRN(1)                   USER COMMANDS                3 July 1991
  533.  
  534.  
  535.  
  536.      Article mode is used for reading and  manipulating  articles
  537.      in  a  single  group.   When a group is entered, the list of
  538.      article subjects displayed contains  those  from  the  first
  539.      unread  article  to  the  last  available article.  Previous
  540.      articles can be obtained by using the prev or subject previ-
  541.      ous  commands.   Hitting  the space bar in Article mode will
  542.      ``do the right thing''; it will scroll an article  if  there
  543.      is more of the article to see and call the next unread func-
  544.      tion if there is no more of the article  to  see.   Clicking
  545.      the  middle  button  on  an  article entry will display that
  546.      article.
  547.  
  548.      quit (artQuit)
  549.           Update the `.newsrc' file and return to group mode.
  550.  
  551.      next unread (artNextUnread)
  552.           Display the selected article if it  is  unread;  other-
  553.           wise, display the first unread article AFTER the cursor
  554.           position.  If no unread articles exist, _x_r_n exits  from
  555.           Article  mode  and returns to Newsgroup mode (or to All
  556.           mode, if Article mode was entered from All mode).
  557.  
  558.      next (artNext)
  559.           Display  the  selected  article,  if  any;   otherwise,
  560.           display  the  next  article in the current group.  Exit
  561.           from Article mode  after  the  last  article  has  been
  562.           reached.
  563.  
  564.      prev (artPrev)
  565.           Display  the  selected  article,  if  any;   otherwise,
  566.           display the previous article in the current group.
  567.  
  568.      last (artLast)
  569.           Display the last article accessed before the  currently
  570.           displayed  one.   This  command only keeps track of one
  571.           previously accessed article, so invoking it  repeatedly
  572.           simply toggles the display between two articles.
  573.  
  574.      next newsgroup (artNextGroup)
  575.           Go directly to the next  newsgroup  with  unread  news,
  576.           bypassing Newsgroup or All mode.
  577.  
  578.      catch up (artCatchUp)
  579.           Mark all articles in the current group as read;  return
  580.           to  Newsgroup mode.  Articles marked as unread by 'mark
  581.           unread' will not be marked as read.   It  a  particular
  582.           article is selected, catch up from the beginning of the
  583.           group to the selected article.
  584.  
  585.      fed up (artFedUp)
  586.           Mark all articles in the current group as read;  go  to
  587.           the next newsgroup.
  588.  
  589.  
  590.  
  591. X UCB                                                           9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. XRN(1)                   USER COMMANDS                3 July 1991
  599.  
  600.  
  601.  
  602.      goto article (artGotoArticle)
  603.           Go to the specified article number (for which the  user
  604.           will be prompted with a dialog box).
  605.  
  606.      mark read (artMarkRead)
  607.           Mark an article (or group of articles) as  read.   This
  608.           command  marks  either  the  selected article(s) or the
  609.           article the cursor is on, and leaves the cursor at  its
  610.           current position.
  611.  
  612.      mark unread (artMarkUnread)
  613.           Mark an article (or group of articles) as unread.  This
  614.           command  marks  either  the  selected article(s) or the
  615.           article the cursor is on, and leaves the cursor at  its
  616.           current position.  When an article is marked as unread,
  617.           a 'u' is placed in the far  left  column  next  to  the
  618.           article's  number.   The  next, prev, subject next, and
  619.           subject prev buttons will all display this  article  if
  620.           they  come  across  it, but the next unread button will
  621.           not.  The only way to mark an article as read  once  it
  622.           has  been  marked  with  a  'u' is to use the mark read
  623.           function.
  624.  
  625.      unsubscribe (artUnsub)
  626.           Unsubscribe from the current group; exit  from  Article
  627.           mode.
  628.  
  629.      subject next (artSubNext)
  630.           Find and display the next article with the same subject
  631.           as  the current article (stripping the '[rR][eE]:' gar-
  632.           bage).  If there are no more articles with the  current
  633.           subject  and  there are more unread articles, the first
  634.           unread article is selected.  If there are no more arti-
  635.           cles  with  the  current  subject and there are no more
  636.           unread articles, Article mode is exited.
  637.  
  638.      subject prev (artSubPrev)
  639.           Find and display the previous  article  with  the  same
  640.           subject as the current article.
  641.  
  642.      list old (artListOld)
  643.           List all articles available in the  group,  even  those
  644.           that  have  been  read.  Note that this button does not
  645.           toggle (clicking this button twice  will  not  put  you
  646.           back to where you were).
  647.  
  648.      session kill (artKillSession)
  649.           Mark all articles with the current subject as read, for
  650.           this session only.
  651.  
  652.      local kill (artKillLocal)
  653.           Mark all articles with the current subject as read  for
  654.  
  655.  
  656.  
  657. X UCB                                                          10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. XRN(1)                   USER COMMANDS                3 July 1991
  665.  
  666.  
  667.  
  668.           this group, for this and all future sessions.
  669.  
  670.      global kill (artKillGlobal)
  671.           Mark all articles with the current subject as read  for
  672.           all groups, for this and all future sessions.
  673.  
  674.      author kill (artKillAuthor)
  675.           Mark all articles by the current  author  as  read  for
  676.           this session only.
  677.  
  678.      subject search (artSubSearch)
  679.           Begin a regular expression subject search.   When  this
  680.           button  is  invoked, a window pops up querying the user
  681.           for a regular expression (of the form used in ed),  and
  682.           a  direction  in which to search.  If a regular expres-
  683.           sion is not typed in, the last  regular  expression  is
  684.           used,  and the search direction is the one specified in
  685.           the dialog box (this can be used to switch  the  direc-
  686.           tion of the search without retyping the expression).
  687.  
  688.      continue (artContinue)
  689.           Continue the last regular expression search by  search-
  690.           ing  for the same regular expression in the same direc-
  691.           tion.
  692.  
  693.      scroll forward (artScroll)
  694.           Scroll the article text forward a page.
  695.  
  696.      scroll backward (artScrollBack)
  697.           Scroll the article text backward a page.
  698.  
  699.      post (artPost)
  700.           Post an article to the current  group.   A  scrollable,
  701.           editable  text window will appear with a header and the
  702.           user's `~/.signature' file  included.   An  appropriate
  703.           header  will be generated with a number of blank header
  704.           fields that if left blank  will  be  deleted  from  the
  705.           posting.  The editor defaults to the standard X toolkit
  706.           editor (similar to _e_m_a_c_s(1)),  Another  editor  can  be
  707.           specified  using the -editorCommand command line option
  708.           or by setting the same X resource (see the  section  on
  709.           command line arguments).  The mouse buttons can be used
  710.           to select text in this window (which can then be placed
  711.           in a file, for example).
  712.  
  713.           There are five buttons at the bottom of the editor win-
  714.           dow:  abort to abort the article (or message, if a mail
  715.           message is being written rather than an  article,  send
  716.           to  post/send  it,  save  to save it in a file, include
  717.           file to include a file (for which the user is  prompted
  718.           with  a dialog box) at the current cursor location, and
  719.           include article to include  the  text  of  the  current
  720.  
  721.  
  722.  
  723. X UCB                                                          11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. XRN(1)                   USER COMMANDS                3 July 1991
  731.  
  732.  
  733.  
  734.           article  at  the  current cursor location.  The include
  735.           article button is omitted if there is no current  arti-
  736.           cle (e.g. if the user is sending a "Gripe" or if "post"
  737.           was selected from Newsgroup mode).  Only one article or
  738.           message window can be active at a time.
  739.  
  740.      exit (artExit)
  741.           Exit article mode, marking all articles listed  in  the
  742.           top window as unread.
  743.  
  744.      checkpoint (artCheckPoint)
  745.           Update the `.newsrc' file.  _x_r_n  normally  updates  the
  746.           `.newsrc'  file  on  `rescan'  and  `quit' in Newsgroup
  747.           mode. This allows you  to  update  the  `.newsrc'  file
  748.           without  exiting _x_r_n or reconnecting to the server (see
  749.           also 'ngCheckPoint').
  750.  
  751.      gripe (artGripe)
  752.           Send a gripe (bug, bug fix, complaint, feature request,
  753.           etc.) to the authors of the program.
  754.  
  755.      save (artSave)
  756.           Save the current article in a file, or use the  current
  757.           article  as standard input to a command.  The save com-
  758.           mand will pop up a dialog box for  the  filename.   The
  759.           dialog  box  has  two  buttons: abort and save.  If the
  760.           filename begins with a `|', the article will be sent to
  761.           the  command  specified  after the `|'.  Otherwise, the
  762.           article will be appended to the file specified.  If the
  763.           name  is  relative  (does  not  begin with `/' or `~'),
  764.           `~/News/' will be prepended to it.  If the name  begins
  765.           with  a `+' the name is assumed to be an MH mail folder
  766.           and a `refile' command will be done on the article.  If
  767.           no   name   is   specified,   it   will   be  saved  in
  768.           `~/News/<groupname>', where `<groupname>' is  the  name
  769.           of  the current group with the first letter capitalized
  770.           (following the _r_n(1) article saving  conventions).   If
  771.           -saveMode     is     set     to     `subdirs',     then
  772.           `~/News/<groupname>/'   will   be   used   instead   of
  773.           `~/News/'.  If multiple articles are selected, all will
  774.           be appended to the same file; however, if the file name
  775.           has  a %d in it, the %d will be replaced with the arti-
  776.           cle number and each article will be saved in a separate
  777.           file.
  778.  
  779.      reply (artReply)
  780.           Reply (by mail) to the author of the  current  article.
  781.           See  post for a description of how to create and send a
  782.           message.
  783.  
  784.      forward (artForward)
  785.           Send the current article to another person via mail.
  786.  
  787.  
  788.  
  789. X UCB                                                          12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. XRN(1)                   USER COMMANDS                3 July 1991
  797.  
  798.  
  799.  
  800.      followup (artFollowup)
  801.           Post a followup article to the  current  article.   See
  802.           post  for  a  description  of how to create and send an
  803.           article.
  804.  
  805.      cancel (artCancel)
  806.           Cancel the current article.
  807.  
  808.      rot-13 (artRot13)
  809.           Decrypt  a  encrypted  article.    In   the   newsgroup
  810.           `rec.humor',  occasionally  articles are submitted that
  811.           may offend certain people  or  groups  of  people.   In
  812.           order  to  minimize  the  offense,  these  articles are
  813.           posted in an encrypted form.  This button will  decrypt
  814.           them.
  815.  
  816.      toggle header (artHeader)
  817.           Show the full text of an article,  including  the  full
  818.           header.
  819.  
  820.      print article (artPrint)
  821.           Send the article to the printer (see the `printCommand'
  822.           command line option).
  823.  
  824.  
  825. CUSTOMIZING XRN
  826.      Colors, fonts, and other _x_r_n options can be specified on the
  827.      command  line  or  using X resources.  With the exception of
  828.      the display name, all _x_r_n options can be specified  using  X
  829.      resources.   Options specified on the command line take pre-
  830.      cedence over those specified using X resources.
  831.  
  832.  
  833. COMMAND LINE ARGUMENTS
  834.      Here are the current command line arguments (the X resources
  835.      have  the  same  names  and values as the command line argu-
  836.      ments).  Under VMS all command line arguments are in  lower-
  837.      case.
  838.  
  839.      +/-authorFullName
  840.                Display  the  full  name  of  the  author  or  the
  841.                user/hostname of the author.
  842.  
  843.      -breakLength len
  844.                Break lines longer than `len' characters into mul-
  845.                tiple  lines.  Default is 0 characters.  If set to
  846.                0,   line   breaking   is   disabled   (see   also
  847.                'lineLength').
  848.  
  849.      -cancelCount number
  850.                The number of articles to search before popping up
  851.                the cancel button.
  852.  
  853.  
  854.  
  855. X UCB                                                          13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. XRN(1)                   USER COMMANDS                3 July 1991
  863.  
  864.  
  865.  
  866.      +/-cc     Put 'Cc: user' in replies.  (X resources class  is
  867.                "CC".)
  868.  
  869.      +/-ccForward
  870.                Put  'Cc:  user'  in   forwarded   messages.    (X
  871.                resources class is "CC".)
  872.  
  873.      -confirm list
  874.                Turn on confirmation boxes for the buttons listed.
  875.                These  boxes  pop up to ask the user to verify the
  876.                invocation of "dangerous" actions (such  as  catch
  877.                up  and  unsubscribe).   The  list of buttons is a
  878.                comma separated list of button names.  The buttons
  879.                that  can be confirmed: ngQuit, ngExit, ngCatchUp,
  880.                artCatchUp, ngUnsub, and artUnsub.
  881.  
  882.      -deadLetters file
  883.                The name of the file to save failed  postings  and
  884.                messages.  Defaults to `~/dead.letters'.
  885.  
  886.      +defaultLines count
  887.                Number of lines to scroll.
  888.  
  889.      -display display
  890.                specification of the X display.
  891.  
  892.      +/-displayLocalTime
  893.                Display the 'Date:' field of the article using the
  894.                local time zone (instead of GMT).
  895.  
  896.      +distribution dist
  897.                Set the default distribution to `dist'.
  898.  
  899.      +/-dumpCore
  900.                Dump core  when  a  signal  is  detected.   The  X
  901.                resources  class  for the "dumpCore" X resource is
  902.                "Debug".
  903.  
  904.      -editorCommand command
  905.                Use an alternate  editor  for  creating  postings,
  906.                followups,  forwards,  gripes, and replies.  `com-
  907.                mand' must be a string in _s_p_r_i_n_t_f(3)  format  con-
  908.                taining a `%s', which will be replaced by the file
  909.                name to be edited.  The command will  be  executed
  910.                using the bourne shell (_s_h(1)).  Examples are:
  911.  
  912.                  xterm -e vi %s
  913.                  xterm -e microEmacs %s
  914.                  emacsclient %s
  915.  
  916.               The resulting command should handle all editing and
  917.               windowing.   The  article  being  followed  up  on,
  918.  
  919.  
  920.  
  921. X UCB                                                          14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. XRN(1)                   USER COMMANDS                3 July 1991
  929.  
  930.  
  931.  
  932.               replied to or forwarded is automatically included.
  933.  
  934.      -includeCommand command
  935.                Use an alternate  program  for  inserting  current
  936.                article  text when following up on, replying to or
  937.                forwarding a message.  `command' must be a  string
  938.                in  _s_p_r_i_n_t_f  format that contains two `%s's, which
  939.                will be replaced by the  include  prefix  and  the
  940.                article file name (in that order).  Examples are:
  941.  
  942.                  sed -e 's/^/%s /' %s
  943.                  xmh-insert-reply -separator '%s' %s
  944.  
  945.               The command provided should output to its  standard
  946.               output  the  text  to  be  included in the message,
  947.               derived as desired from the prefix and the contents
  948.               of  the article file.  The command will be executed
  949.               using the bourne shell.
  950.  
  951.      -geometry WxH+X+Y
  952.                Specification of the _x_r_n window size and location.
  953.                The  window  manager  may  choose  to  ignore this
  954.                specification.
  955.  
  956.      -iconic   Start up _x_r_n with the window iconified.
  957.  
  958.      -iconGeometry +X+Y
  959.                Specification of the initial  _x_r_n  icon  location.
  960.                The  window  manager  may  choose  to  ignore this
  961.                specification.
  962.  
  963.      +/-includeHeader
  964.                Include or do not include the original  header  in
  965.                included  articles.  The default is to not include
  966.                the header.
  967.  
  968.      +/-extraMailHeaders
  969.                When replying via mail to a posting, include or do
  970.                not include an "X-Newsgroups:" line with the news-
  971.                groups list from the posting and a  "In-reply-to:"
  972.                line with its message ID.
  973.  
  974.      -includePrefix prefix text
  975.                Change  the  standard  prefix  for  each  line  of
  976.                included  text  from  the  default,  "|> ", to the
  977.                given text string.
  978.  
  979.      +/-includeSep
  980.                Include or do not include the prefix text ("|>  ")
  981.                in  front of included articles.  The default is to
  982.                include the prefix text ("|> ").
  983.  
  984.  
  985.  
  986.  
  987. X UCB                                                          15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. XRN(1)                   USER COMMANDS                3 July 1991
  995.  
  996.  
  997.  
  998.      +/-info   Display all informative messages  in  the  message
  999.                pane.   Defaults to display all information in the
  1000.                message pane.
  1001.  
  1002.      +/-killFiles
  1003.                Turn the use of kill files on/off.  The default is
  1004.                on.   See  _r_n(1)  for documentation about how kill
  1005.                files work (however, see the  BUGS  section  below
  1006.                for a description of the limitations in _x_r_n's kill
  1007.                file handling).
  1008.  
  1009.      -leaveHeaders list
  1010.                The header fields to leave in the article; a comma
  1011.                separated  case-insensitive  list  of  field names
  1012.                (_i._e.,  subject,from,organization).   This  option
  1013.                takes precedence over `stripHeaders'.  If the word
  1014.                `all' is specified instead of a  list  of  fields,
  1015.                then  all  headers  will  be retained (This can be
  1016.                used in user X resources to  override  a  resource
  1017.                specified  in the global _x_r_n application defaults,
  1018.                or on the command  line  to  override  a  resource
  1019.                specified  in  either  the application defaults or
  1020.                the user X resources.).
  1021.  
  1022.      -lineLength len
  1023.                Length of lines that are  broken.   Default  is  0
  1024.                characters.   If  set  to 0, line breaking is dis-
  1025.                abled (see also 'breakLength').
  1026.  
  1027.      -lockFile file
  1028.                Set the XRN lock file name to `file'.  Defaults to
  1029.                `~/.xrnlock'.
  1030.  
  1031.      -mailer mailer
  1032.                The command to use for mailing replies.  This com-
  1033.                mand  must  take  all  of it's input from stardard
  1034.                input (_x_r_n will not build a  command  line).   The
  1035.                default is `/usr/lib/sendmail -oi -t'.  Under VMS,
  1036.                the default is `MAIL'.
  1037.  
  1038.      -minLines number
  1039.                The minimum number of lines above  the  cursor  in
  1040.                the  subject  line display.  If negative, the sub-
  1041.                ject line display scrolls only at the  bottom  and
  1042.                only one line at a time.
  1043.  
  1044.      -maxLines number
  1045.                The maximum number of lines above  the  cursor  in
  1046.                the  subject  line display.  If negative, the sub-
  1047.                ject line scrolls only at the bottom and only  one
  1048.                line at a time.
  1049.  
  1050.  
  1051.  
  1052.  
  1053. X UCB                                                          16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. XRN(1)                   USER COMMANDS                3 July 1991
  1061.  
  1062.  
  1063.  
  1064.      -newsrcFile file
  1065.                The newsrc file to use.  Defaults to  `~/.newsrc'.
  1066.                If  a  file with a name of the form `<newsrcFile>-
  1067.                <nntpServer>' is found, it will be used.
  1068.  
  1069.      -nntpServer hostname
  1070.                The NNTP server to use (name or internet number).
  1071.  
  1072.      -organization organization
  1073.                Set the organization name in postings and  follow-
  1074.                ups.   You  can  also set the environment variable
  1075.                ORGANIZATION  (NEWSORG  on  Apollo)  to  set   the
  1076.                default organization name.
  1077.  
  1078.      +/-pageArticles
  1079.                Space bar with either scroll the  current  article
  1080.                or go to the next article.
  1081.  
  1082.      -pointerBackground color
  1083.                Set the background color of the mouse cursor.  The
  1084.                default  color  is whatever the default background
  1085.                color is for xrn.
  1086.  
  1087.      -pointerForeground color
  1088.                Set the foreground color of the mouse cursor.  The
  1089.                default  color  is whatever the default foreground
  1090.                color is for xrn.
  1091.  
  1092.      -printCommand command
  1093.                Set the command used for printing  articles.   The
  1094.                article is sent to the command via standard input.
  1095.                Defaults to `enscript -g'.
  1096.  
  1097.      -replyTo name
  1098.                Set the Reply-To field for articles and mail  mes-
  1099.                sages.
  1100.  
  1101.      -rescanTime time
  1102.                Amount of idle time (in seconds)  before  checking
  1103.                for new articles.
  1104.  
  1105.      +/-resetSave
  1106.                Reset the string in the  'save'  dialog  box  upon
  1107.                entering each newsgroup.
  1108.  
  1109.      -saveDir dir
  1110.                The  article  saving   directory.    Defaults   to
  1111.                `~/News'  when  -saveMode  specifies  `onedir', or
  1112.                `~/News/newsgroup' when -saveMode specifies  `sub-
  1113.                dirs'.
  1114.  
  1115.      -saveMode mode
  1116.  
  1117.  
  1118.  
  1119. X UCB                                                          17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. XRN(1)                   USER COMMANDS                3 July 1991
  1127.  
  1128.  
  1129.  
  1130.                The mode for saving articles;  a  comma  separated
  1131.                list  of options.  The options can be `mailbox' or
  1132.                `normal', `headers' or `noheaders',  and  `onedir'
  1133.                or       `subdirs'.       The      default      is
  1134.                `normal,headers,onedir'.
  1135.  
  1136.      -saveNewsrcFile file
  1137.                The  saved   `.newsrc'   filename.    Before   the
  1138.                `.newsrc' file is modified on startup, it is saved
  1139.                in a backup file.  Defaults to `~/.oldnewsrc'.
  1140.  
  1141.      -savePostings file
  1142.                The name of the file in which to save postings and
  1143.                messages (via the `save' button in the composition
  1144.                window).  Defaults to `~/Articles'.
  1145.  
  1146.      -saveString string
  1147.                Use 'string' as the default in the  'save'  dialog
  1148.                box.
  1149.  
  1150.      -signatureFile file
  1151.                The signature file to use.  Defaults to `~/.signa-
  1152.                ture'.
  1153.  
  1154.      +/-sortedSubjects
  1155.                Display the subject lines in  the  subject  window
  1156.                sorted by subject.
  1157.  
  1158.      +/-subjectRead
  1159.                When using the space bar to scroll, when an  arti-
  1160.                cle  is  finished, the space-bar scrolling invokes
  1161.                subject next instead of next unread.
  1162.  
  1163.      -stripHeaders list
  1164.                The header fields to strip  from  the  article;  a
  1165.                comma  separated  case-insensitive  list  of field
  1166.                names (_i._e., keywords,message-id).   If  the  word
  1167.                `none'  is  specified instead of a list of fields,
  1168.                then no headers will be stripped (This can be used
  1169.                in  user X resources to override a resource speci-
  1170.                fied in the global _x_r_n application defaults, or on
  1171.                the  command line to override a resource specified
  1172.                in either the application defaults or the  user  X
  1173.                resources.).
  1174.  
  1175.      -tmpDir directory
  1176.                The directory to use for the temporary storage  of
  1177.                articles  fetched from the server.  If this option
  1178.                and the corresponding X resource do not exist, _x_r_n
  1179.                will  look  for  the  environment variable TMPDIR.
  1180.                The default is `/tmp'.
  1181.  
  1182.  
  1183.  
  1184.  
  1185. X UCB                                                          18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. XRN(1)                   USER COMMANDS                3 July 1991
  1193.  
  1194.  
  1195.  
  1196.      -topLines number
  1197.                The number of lines to be used for  the  top  text
  1198.                window  (where  the unread groups and article sub-
  1199.                jects are listed).
  1200.  
  1201.      +/-typeAhead
  1202.                Allow/disallow  typeahead.   Defaults   to   allow
  1203.                typeahead.
  1204.  
  1205.      +/-updateNewsrc
  1206.                Update the newsrc file when leaving Article mode.
  1207.  
  1208.      +/-useGadgets
  1209.                Use 'gadgets'  rather  than  full  widgets  (MOTIF
  1210.                only).
  1211.  
  1212.      +/-verboseKill
  1213.                List subjects or just give a  count  when  killing
  1214.                articles. The default is on.
  1215.  
  1216.      -ngButtonList list
  1217.  
  1218.      -artButtonList list
  1219.  
  1220.      -artSpecButtonList list
  1221.  
  1222.      -addButtonList list
  1223.  
  1224.      -allButtonList list
  1225.                Use the given list of buttons for  the  particular
  1226.                mode  in  the  order  given rather than all of the
  1227.                buttons for the mode in the  default  order.   The
  1228.                list  is  a  comma separated list of button names.
  1229.                The names of the buttons  appear  next  after  the
  1230.                button  label  in  the  button descriptions above.
  1231.                For example, a list of buttons for Newsgroup  mode
  1232.                might                                          be:
  1233.                ngQuit,ngRead,ngCatchUp,ngRescan,ngSubscribe,ngPost
  1234.  
  1235.      -ngBindings bindings
  1236.  
  1237.      -allBindings bindings
  1238.  
  1239.      -addBindings bindings
  1240.  
  1241.      -artBindings bindings
  1242.                Use the given bindings for the key/mouse  bindings
  1243.                for the particular mode.  The default key bindings
  1244.                are as close to the _r_n key bindings  as  possible.
  1245.                See  the  X  toolkit documentation on `Translation
  1246.                Tables' for information on the  format  of  `bind-
  1247.                ings'.  The actions defined in _x_r_n are the same as
  1248.  
  1249.  
  1250.  
  1251. X UCB                                                          19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. XRN(1)                   USER COMMANDS                3 July 1991
  1259.  
  1260.  
  1261.  
  1262.                the button names.  For example, a set of  bindings
  1263.                for Newsgroup mode might be:
  1264.                    xrn.ngBindings: \
  1265.                       <Key>Q:      ngQuit()  \n\
  1266.                       <Key>N:      ngRead()  \n\
  1267.                       <Key>P:      ngPrev()
  1268.  
  1269. X RESOURCES
  1270.      _x_r_n takes a number  of  specifications  for  colors,  fonts,
  1271.      border widths, and other program options.  The format for an
  1272.      _x_r_n X resource is
  1273.  
  1274.                         xrn.x.y....z.a: value
  1275.  
  1276.      where _x._y...._z specifies the path from the top level of  _x_r_n
  1277.      to a particular item (think of _x_r_n as a hierarchical collec-
  1278.      tion of windows, panes, and buttons, and _x._y...._z is a  path
  1279.      from the top of the hierarchy to a node in the hierarchy), _a
  1280.      is the type of  default  (_i._e.,  font,  border,  foreground,
  1281.      background,  borderWidth),  and  _v_a_l_u_e  is  the value of the
  1282.      default (_i._e,. a color name or hex  representation,  a  font
  1283.      name,  a numeric value).  Specifying a default for a item at
  1284.      some point in the hierarchy will set that  default  for  all
  1285.      items from that point down in the hierarchy.  A higher level
  1286.      default can be overridden by specifying a default at a lower
  1287.      level directly.
  1288.  
  1289.      XRN widget hierarchy:
  1290.      vpane (Paned)
  1291.        titlebar (Label)  (optional)
  1292.        index (Text)
  1293.        indexinfo (Label)
  1294.        indexbuttons (Box)
  1295.            buttonName (Command)
  1296.        articleText (Text)
  1297.        textinfo (Label)
  1298.        textbuttons (Box)
  1299.            buttonName (Command)
  1300.  
  1301.      Composition (Shell)
  1302.        vpane (Paned)
  1303.          label (Label)
  1304.          text (Text)
  1305.          box (Box)
  1306.             abort (Command)
  1307.             send (Command)
  1308.             save (Command)
  1309.             includeArticle (Command)
  1310.             includeFile (Command)
  1311.  
  1312.      dialogs...
  1313.  
  1314.  
  1315.  
  1316.  
  1317. X UCB                                                          20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. XRN(1)                   USER COMMANDS                3 July 1991
  1325.  
  1326.  
  1327.  
  1328.      Examples of defaults are:
  1329.         #
  1330.         xrn.newsrcFile:          ~/.newsrc
  1331.         xrn.nntpServer:          pasteur
  1332.         xrn.organization:   UC Berkeley XRN Design Team
  1333.         xrn.replyTo:        user@machine.domain
  1334.         xrn.iconGeometry:   +64+521
  1335.         xrn.leaveHeaders:   subject,from
  1336.         xrn.includeHeader:  off
  1337.         xrn.signatureFile:  ~/.signature
  1338.         xrn.geometry:       =750x770+10+10
  1339.         xrn.deadLetters:    ~/dead.letters
  1340.         xrn.savePostings:   ~/Articles
  1341.         xrn.topLines:       9
  1342.         xrn.saveMode:       mailbox,headers,onedir
  1343.         xrn.minLines:       3
  1344.         xrn.maxLines:       6
  1345.         xrn.tmpDir:         /tmp
  1346.         xrn.mailer:         /usr/lib/sendmail -oi -t
  1347.         #
  1348.         xrn.Gripe.geometry: +50+50
  1349.         #
  1350.         xrn.ngButtonList: ngQuit,ngRead,ngCatchUp,ngRescan,ngSubscribe,ngPost
  1351.         xrn.artButtonList: artQuit,artNextUnread,artCatchUp,artPost,artNextGroup
  1352.         #
  1353.         xrn.ngBindings: \
  1354.            <Key>Q:          ngQuit()  \n\
  1355.            <Key>N:          ngRead()  \n\
  1356.            <Key>P:          ngPrev()
  1357.         #
  1358.         xrn*background:          plum
  1359.         xrn*foreground:          red
  1360.         xrn*font:      9x15
  1361.         xrn*border:         LightGray
  1362.         #
  1363.         xrn*Text*Background:     DarkSlateGray
  1364.         xrn*Text*Foreground:     yellow
  1365.         xrn*ScrollBarMgr.thickness: 22
  1366.         xrn*ScrollBar.background: DarkSlateGray
  1367.         xrn*ScrollBar.foreground: yellow
  1368.         xrn*ScrollBar.border: White
  1369.         xrn*Label.background:         cyan
  1370.         xrn*Label.foreground:         blue
  1371.         xrn*Command.foreground:       White
  1372.         xrn*Command.background:       coral
  1373.         #
  1374.         xrn*Box.ngQuit.foreground:    Black
  1375.         xrn*Box.ngQuit.background:    red
  1376.         #
  1377.         xrn*dialog*font:         9x15
  1378.         xrn*dialog*background:        LimeGreen
  1379.         xrn*dialog*foreground:        CornflowerBlue
  1380.  
  1381.  
  1382.  
  1383. X UCB                                                          21
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390. XRN(1)                   USER COMMANDS                3 July 1991
  1391.  
  1392.  
  1393.  
  1394.         xrn*dialog*Label.foreground:  NavyBlue
  1395.         xrn*dialog*Command.foreground:     Black
  1396.         xrn*dialog*Command.background:     yellow
  1397.         xrn*dialog*Text.background:   Wheat
  1398.         xrn*dialog*Text.foreground:   SteelBlue
  1399.         xrn*dialog*borderWidth:       2
  1400.         #
  1401.  
  1402.  
  1403. FILES
  1404.      ~/.newsrc      description of the groups  and  the  articles
  1405.      read in each group
  1406.      ~/.oldnewsrc        backup of ~/.newsrc (created at startup)
  1407.      ~/.signature        signature for use when sending messages
  1408.      ~/News              directory where articles are saved
  1409.      ~/Articles          where `saved' postings and messages  are
  1410.      stored
  1411.      ~/dead.letter       where failed postings and  messages  are
  1412.      stored
  1413.      ~/.xrnlock          lock file
  1414.      /usr/local/lib/rn/server location of the news  server  host-
  1415.      name (optional)
  1416.      /usr/local/lib/news/hiddenhost     location  of   the   hid-
  1417.      denhost name (optional)
  1418.      /usr/local/lib/news/pathhost  location of the path host name
  1419.      (optional)
  1420.      /usr/local/lib/news/domain    location of  the  domain  name
  1421.      (optional)
  1422.      /etc/uucpname       location of the UUCP name for your  host
  1423.      (optional)
  1424.      /usr/lib/sendmail        default mailer
  1425.      CHANGES             list of changes from the  previous  ver-
  1426.      sion
  1427.      TODO           list of bugs and things to do
  1428.  
  1429.  
  1430. ENVIRONMENT VARIABLES
  1431.      NNTPSERVER          hostname of the news server
  1432.      TMPDIR         temporary directory
  1433.      DOMAIN         name     of     your     internet      domain
  1434.      (".Berkeley.EDU", ".orst.edu")
  1435.      HIDDENHOST     full domain-style name of the host  that  you
  1436.      want   your   return  path  to  be  from  ("decvax.dec.com",
  1437.      "Berkeley.EDU")
  1438.      HIDDENPATH     name of the host that you  want  put  in  the
  1439.      Path field of messages.
  1440.      USER      login name of the user.
  1441.      HOME      home directory of the user.
  1442.      FULLNAME  full name of the user, used for the From field  of
  1443.      messages.
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449. X UCB                                                          22
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456. XRN(1)                   USER COMMANDS                3 July 1991
  1457.  
  1458.  
  1459.  
  1460. SEE ALSO
  1461.      emacs(1), readnews(1), rn(1),  sh(1)  sprintf(3),  vnews(1),
  1462.      X(1), nntpd(8)
  1463.  
  1464.  
  1465. COMMENTS
  1466.      The name (_x_r_n) is a bit of a misnomer.   _x_r_n  is  not  an  X
  1467.      interface  to  `rn' (the terminal-based news reading program
  1468.      by Larry Wall), but is an X-based news reader that  has  had
  1469.      part  of  the  functionality of `rn' added since a number of
  1470.      our users are (were?) `rn' users (all of the code  is  new).
  1471.      Much of the `rn' funcionality that _x_r_n currently has was not
  1472.      in the original plan (KILL files, for example).
  1473.  
  1474.      The user interface look and feel is modeled  after  that  of
  1475.      `XMH' (by Terry Weissman).
  1476.  
  1477.      The `.newsrc' file is updated on executing the  `quit'  com-
  1478.      mand  in  Newsgroup  mode,  during  every  `rescan',  and by
  1479.      `checkpoint'.  If the  `updateNewsrc'  option  is  set,  the
  1480.      `.newsrc'  file  will  be  updated everytime Article mode is
  1481.      exited.
  1482.  
  1483.      _x_r_n catches signals and X errors and will clean up on  error
  1484.      exit  (remove  temporary  files, update the `.newsrc' file).
  1485.      The cleanup will be done and then a death notifier box  will
  1486.      be  posted  (if  the  signal  is SIGHUP or SIGINT, the death
  1487.      notifier will be skipped and the program  will  exit).   The
  1488.      "click to exit" button must be pressed in the death notifier
  1489.      box for the program to exit.
  1490.  
  1491.      XREFS are handled by _x_r_n, however  only  articles  that  are
  1492.      actually  read  (not marked as read by 'catchup' or 'mark as
  1493.      read') have their XREFS chased  and  only  groups  that  are
  1494.      currently subscribed to have XREFed articles marked as read.
  1495.  
  1496.      The default  specifications  for  color  and  fonts  can  be
  1497.      confusing  (thousands of different X resources can be speci-
  1498.      fied for _x_r_n, no two users' _x_r_n  displays  need  to  be  the
  1499.      same).
  1500.  
  1501.      _x_r_n uses the XHDR command of the Berkeley NNTP  news  server
  1502.      (XHDR  is not part of the protocol defined by RFC 977).  _x_r_n
  1503.      will detect the presence of this command and complain if  it
  1504.      does not exist.
  1505.  
  1506.      Since the NNTP protocol does not define  a  unique  response
  1507.      code  for  server  timeout, timeout recovery may not work if
  1508.      the format of the timeout error message changes.
  1509.  
  1510.      _x_r_n assumes a `smart' or `lucky' mailer.
  1511.  
  1512.  
  1513.  
  1514.  
  1515. X UCB                                                          23
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522. XRN(1)                   USER COMMANDS                3 July 1991
  1523.  
  1524.  
  1525.  
  1526.      _x_r_n notices that the `.newsrc'  file  has  been  updated  by
  1527.      another  program  while  _x_r_n is running and informs the user
  1528.      (and gives the user the option to quit without updating  the
  1529.      `.newsrc' or to continue on).
  1530.  
  1531.      Article temporary files can be removed and _x_r_n will recover.
  1532.  
  1533.      _x_r_n strips `<character>^H' from articles.
  1534.  
  1535.      The v{f,s}printf implementation included with  _x_r_n  is  from
  1536.      Robert A. Larson <blarson@skat.usc.edu>.
  1537.  
  1538.      The strtok implementation included with _x_r_n  is  from  Henry
  1539.      Spencer <henry@zoo.toronto.edu>.
  1540.  
  1541.      PointerForeground is the resource name for the color of  the
  1542.      cursor     (pointer).      Some     other    programs    use
  1543.      PointerColor/CursorColor.
  1544.  
  1545. BUGS
  1546.      See TODO for a full list of bugs and things that need to  be
  1547.      done.
  1548.  
  1549.      Incomplete KILL file support: the THRU line is not  updated,
  1550.      the only actions supported are 'm', 'j', and 's', and match-
  1551.      ing is always done against both  the  ``From:''  and  ``Sub-
  1552.      ject:'' lines of postings.
  1553.  
  1554.      See config.h for a list of defines you may want to use based
  1555.      on  problems  that  may  exist  in  your  version of the X11
  1556.      toolkit and widgets.
  1557.  
  1558.      Report    bugs    and    requests    for     features     to
  1559.      `xrn@eros.berkeley.edu' (...!ucbvax!eros!xrn).
  1560.  
  1561.      Requests to be placed on the _x_r_n users mailing  list  should
  1562.      be     sent     to     `xrn-users-request@eros.berkeley.edu'
  1563.      (...!ucbvax!eros!xrn-users-request).
  1564.  
  1565. ORIGINAL AUTHORS
  1566.      Ellen  M  Sentovich  (UC  Berkeley,   ellen@ic.berkeley.edu,
  1567.      ...!ucbvax!ic!ellen)
  1568.      Rick L Spickelmier (formerly UC Berkeley,  now  Objectivity,
  1569.      Inc., ricks@berkeley.edu, ...!ucbvax!ricks, ricks@objy.com)
  1570.      Mike Yang <mikey@sgi.com> wrote the MOTIF interface.
  1571.      Jonathan I. Kamens <jik@pit-manager.mit.edu> has done a mas-
  1572.      sive amount of bug fixing and feature adding.
  1573.      See the FIXERS/CHANGES files for a listing of those who have
  1574.      really been doing most of the work over the last year or so!
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581. X UCB                                                          24
  1582.  
  1583.  
  1584.  
  1585.